Paperless-NGX: Fehler „database paperless has a collation version mismatch“ schnell behoben

Vor ein paar Tagen habe ich mein Paperless-NGX Setup auf die Version 2.19.6 aktualisiert. Eigentlich nichts Wildes, dachte ich.

Doch direkt danach wurde mein Docker Log mit Warnungen zugespammt.
Und zwar mit diesen hier:

database "paperless" has a collation version mismatch
The database was created using collation version 2.36, but the operating system provides version 2.41.
HINT: Rebuild all objects in this database that use the default collation and run ALTER DATABASE paperless REFRESH COLLATION VERSION, or build PoseSQL with the right library version.

Kurz gesagt: PostgreSQL hat gemerkt, dass mein System inzwischen eine neuere Collation-Version verwendet als die Datenbank selbst. Das passiert gern nach OS-Updates oder Image-Upgrades. Der Container läuft zwar weiter, aber die Logs nerven ohne Ende.

🔍 Was bedeutet das überhaupt?

Paperless nutzt PostgreSQL, und PostgreSQL wiederum verwendet sogenannte „Collations“ für Sortierung und Vergleiche von Zeichenfolgen. Wenn die OS-Bibliothek aktualisiert wurde, aber die Datenbank nicht, erkennt PostgreSQL den Versionsunterschied und wirft Warnungen aus.

Das ist kein kritischer Fehler, aber auf Dauer richtig störend.

🛠 So habe ich das Problem gelöst

Zum Glück ist die Lösung wirklich simpel. Ich habe mich direkt in den Postgres Container eingeloggt:

docker exec -it paperless-db /bin/bash

In meinem Setup heißen sowohl die Datenbank als auch der Benutzer schlicht paperless, daher sehen meine Befehle genau so aus.

Ich öffne psql:

psql -d "paperless" -U "paperless"

Dann der entscheidende Schritt: Die Collation-Version aktualisieren.

ALTER DATABASE paperless REFRESH COLLATION VERSION;

PostgreSQL antwortete sofort mit einem Hinweis, dass die Version jetzt von 2.36 auf 2.41 aktualisiert wurde. Damit war der Spuk schon fast vorbei!

Zum Abschluss habe ich noch ein komplettes Reindexing durchgeführt:

REINDEX DATABASE paperless;

Das baut alle betroffenen Indexe neu auf. Danach war endlich Ruhe im Log. Keine Warnungen mehr, kein Dauer-Spam. Genau so will man das!

🎉 Ergebnis

Direkt nach dem Reindex waren alle Meldungen verschwunden.
Paperless läuft wieder absolut sauber, und die Logs sind wieder so ruhig wie früher.

Wenn du also ebenfalls auf eine neuere Paperless-ngx-Version oder ein aktualisiertes Base-Image wechselst und plötzlich mit „collation version mismatch“ begrüßt wirst: Die oben gezeigten SQL-Befehle lösen das Problem zuverlässig.

👥 Techniverse Community

Lust auf Austausch rund um Matrix, Selfhosting und andere smarte IT-Lösungen?
In der Techniverse Community triffst du Gleichgesinnte, kannst Fragen stellen oder einfach nerdigen Talk genießen. 🚀

👉 Jetzt der Gruppe auf Matrix beitreten
~ Direkte Raumadresse: #community:techniverse.net

👉 Für lockere Gespräche abseits der Kernthemen komm in den Talkraum
~ Direkte Raumadresse: #talk:techniverse.net

Wir freuen uns, wenn du dabei bist!